home *** CD-ROM | disk | FTP | other *** search
/ Skunkware 5 / Skunkware 5.iso / lib / calc / help / command < prev    next >
Text File  |  1995-07-17  |  3KB  |  72 lines
  1. Command sequence
  2.  
  3.     This is a sequence of any the following command formats, where
  4.     each command is terminated by a semicolon or newline.  Long command
  5.     lines can be extended by using a back-slash followed by a newline
  6.     character.  When this is done, the prompt shows a double angle
  7.     bracket to indicate that the line is still in progress.  Certain
  8.     cases will automatically prompt for more input in a similar manner,
  9.     even without the back-slash.  The most common case for this is when
  10.     a function is being defined, but is not yet completed.
  11.  
  12.     Each command sequence terminates only on an end of file.  In
  13.     addition, commands can consist of expression sequences, which are
  14.     described in the next section.
  15.  
  16.  
  17.     NOTE: Calc commands are in lower case.   UPPER case is used below
  18.           for emphasis only, and should be considered in lower case.
  19.  
  20.  
  21.     DEFINE function(params) { body }
  22.     DEFINE function(params) = expression
  23.         This first form defines a full function which can consist
  24.         of declarations followed by many statements which implement
  25.         the function.
  26.  
  27.         The second form defines a simple function which calculates
  28.         the specified expression value from the specified parameters.
  29.         The expression cannot be a statement.  However, the comma
  30.         and question mark operators can be useful.  Examples of
  31.         simple functions are:
  32.  
  33.             define sumcubes(a, b) = a^3 + b^3;
  34.             define pimod(a) = a % pi();
  35.  
  36.     HELP
  37.         This displays a general help message.
  38.  
  39.     READ filename
  40.         This reads definitions from the specified filename.
  41.         The name can be quoted if desired.  The calculator
  42.         uses the CALCPATH environment variable to search
  43.         through the specified directories for the filename,
  44.         similarly to the use of the PATH environment variable.
  45.         If CALCPATH is not defined, then a default path of
  46.         ":/usr/lib/calc" is used (that is, the current directory
  47.         followed by a general calc library directory).  The
  48.         ".cal" extension is defaulted for input files, so that
  49.         if "filename" is not found, then "filename.cal" is then
  50.         searched for.  The contents of the filename are command
  51.         sequences which can consist of expressions to evaluate
  52.         or functions to define, just like at the top level
  53.         command level.
  54.  
  55.     WRITE filename
  56.         This writes the values of all global variables to the
  57.         specified filename, in such a way that the file can be
  58.         later read in order to recreate the variable values.
  59.         For speed reasons, values are written as hex fractions.
  60.         This command currently only saves simple types, so that
  61.         matrices, lists, and objects are not saved.  Function
  62.         definitions are also not saved.
  63.  
  64.     QUIT
  65.         This leaves the calculator, when given as a top-level
  66.         command.
  67.     
  68.  
  69.     Also see the help topic:
  70.  
  71.         statement       flow control and declaration statements
  72.